PEGA Upgrade process 


Based on last upgrade 8.7.3 


PEGA Upgrade process 


Upgrade base/core and modules to a new version 
Last upgrade : version 8.6 -> version 8.7.3 


PEGA Upgrade process 


List of elements (core and modules) to be upgrade in CMT context 
e Pega base/core 

e PEGA Foundation Financial Services module 

e PEGA Customer Services module 


e PEGA Customer Services For financial Services module 


PEGA Upgrade process 


Prerequisite 

“Linux machine (ex: pegtstweb008). 

“Upgrade packages (core and modules). 

e Available JDK in Linux machine. (ex: /home/webdev01/java8) 

e Refreshed database of environment to be upgrade (DEV, UAT or PROD) 
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List of Upgrade packages folders of version 8.7.3 in CMT 


e 117271 Pega8.7.3 : PEGA Base package (contains also 


f-| | 117151. PFFS 8.7 
utilities of upgrade process) | | | | aM 117161_PCRMFS_87 
; E a : PEGA Foundation Financial Services 3-0 117258 PCRM 872 
“11258 PCRM 872 : PEGA Customer Services (PCS) | | 17271 Pega8.7.3 


“117161 PCRMFS 87: PEGA Customer Services For financial 
Services (PCSFFS) 


The upgrade packages folders share by PEGA and must be upload in Linux 
machine 
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How to do ? 


PEGA Upgrade process 


Step 1 : Configure properties 
Configure setupDatabase.properties and prpcUtils.properties in PEGA base/code upgrade package. 


setupDatabase.properties path : /<<Pega base package>>/scripts/setupDatabase.properties) 
prpcUtils.properties path : /<<Pega base package>>/scripts/utils/prpcUtils.properties) 


pega.jdbc. driver.jar=/PEGTSTWEBO08/PRPC/ojdbc/ojdbc8.jar 
pega.jdbc.driver.class=oracle.jdbc.OracleDriver 

pega. database.type=oracledate 
pega.jdbc.url=jdbc:oracle:thin:@//dbbdevdb9632. fr. world.socgen:1522/ PEGZD103 
pega.jdbc.username=DEPLOY USER 

pega.jdbc.password=(in keepass) 

rules.schema.name=PEG RULES OWNER 

data.schema.name=PEG DATA OWNER 

customerdata.schema.name= PEG DATA OWNER 

user temp. dir=/PEGTSTWEB008/pegdev02/PRPC/tempupgrade 
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Step 2 : Script for clean data 
Scripts must be run in SQL Developer on database to be upgrade_ 


SQL script to delete existing sample datas SQL script to prevent errors in upgrade processing 


BEGIN delete FROM PEG_DATA_OWNER.pr_data_token WHERE pzpvstream IS NULL OR 


(Dbms_lob.getlength(pzpvstream) = 0); 
FOR c IN ( SELECT * FROM DBA OBJECTS WHERE OBJECT TYPE = 'TABLE' AND OBJECT NAME LIKE 


'%FSF_SNAP_%'AND OWNER=‘PEG_DATA_OWNER' ) delete from peg_rules_owner.pr4_base where pxobjclass='Data-Admin-DB-Table' and pzinskey='DATA- 
ADMIN-DB-TABLE’; 
LOOP 
EXECUTE IMMEDIATE 'DROP TABLE ' || c OBJECT NAME || ' CASCADE CONSTRAINTS’; 
END LOOP; 
END; 
BEGIN 


FOR c IN ( SELECT * FROM DBA OBJECTS WHERE OBJECT TYPE = 'TABLE' AND OBJECT NAME LIKE 
'%WFSF SAMPLE %' AND OWNER='PEG_DATA_OWNER' ) 


LOOP 


EXECUTE IMMEDIATE 'DROP TABLE PEG DATA OWNER.' || c OBJECT NAME || ' CASCADE 
CONSTRAINTS"; 


END LOOP; 


END; 
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Step 3 : Upgrade PEGA base/core 


Call upgrade.sh in Linux machine in background mode. 


Command: 
nohup /home/pegdev02/PRPC/Upgrade/<< Pega base folder>>/scripts/upgrade.sh > log file core.log & 


Check the log file to confirm the BUILD SUCCESS or ERROR 


Example command execution in upgrade version 8.7.3: 
nohup /home/pegdev02/PRPC/Upgrade/117271 Pega8.7.3/scripts/upgrade.sh > pegaBase.log & 
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Step 4 : Upgrade Pega Foundation Financial Services module (PFFS 
Execute script for each jar file in <<PFFS folder>>/rules in order: 


-  PegaFFS.jar 

-  PegaFFS Sample.jar 

- PegaFFS Schema.jar 

- PegaFFS_Datalnstances.jar 

-  PegaFFS Int.jar 
Command: 
nohup /home/pegdev02/PRPC/Upgrade/<< Pega base folder>>/scripts/utils/prpcUtils.sh import | 
--archivePath PRPC/Upgrade/<<PFFS folder>>/Rules/<<jar file name>> | 


--prpcutils.property.filepath /home/pegdev02/PRPC/Upgrade/<< Pega base folder>>/scripts/utils/prpcUtils. properties > 
log file for jarlog & 


Check the log file of each execution jar to confirm the BUILD SUCCESS or ERROR 


Example command execution in upgrade version 8.7.3 of PegaFFS.jar: 

nohup /home/pegdev0O2/PRPC/Upgrade/117271 Pega8.7.3/scripts/utils/prpcUtils.sh import| 

--archivePath PRPC/Upgrade/117151_PFFS_8.7/Rules/PegaFFS.jar | 

--prpcutils. property. filepath /home/pegdev02/PRPC/Upgrade/ 117271 Pega8.7.3/scripts/utils/prpcltils.properties > PegaFFS.jar./og & 


Upgrade PEGA 


Step 5 : Upgrade Product Designer Financial Services module (PPDFS 
Execute script for each jar file in <<PPDFS folder>>/Resourcekit/PDFS/Rules in order: 


- PegaPDFS.jar 
- PegaPDFS Implementation.jar 


Command: 
nohup /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils.sh import 
--archivePath PRPC/Upgrade/<<PPDFS folder>>/Rules/<<jar file name>> | 


--prpcutils.property.filepath /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils.properties>> 
log file for jarlog & 


Check the log file to confirm the BUILD SUCCESS or ERROR 


Example of command execution in version 8.7.3 of PegaPDFS.jar: 

nohup /home/pegdev02/PRPC/Upgrade/117271 Pega8.7.3/scripts/utils/prpcUtils.sh import| 

--archivePath PRPC/Upgrade/117151_PFFS_8.7/ResourceKit/PDFS/RulesPegaPDFS.jar | 

--prpcutils. property. filepath /home/pegdev02/PRPC/Upgrade/ 117271 Pega8.7.3 /scripts/utils/orpcUtils.properties > PegaPDFS.jar 03112022./0g & 


Upgrade PEGA 


Step 6 : Upgrade Custom Services modules (PCRM 
Execute script for each jar file in <<PCRM_folder>>/ResourceKit/PDFS/Rules in this order: 


-  PegaCRM.jar 
-  PegaCRM Patch.jar 


Command: 
nohup /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils.sh import! 
--archivePath PRPC/Upgrade/<<PCRM folder>>/Rules/<<jar file name>> | 


--prpcutils. property.filepath /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils.properties > <<jar 
name>> <<current date>>.log & 


Check the log file to confirm the BUILD SUCCESS or ERROR 


Example command execution in upgrade version 8.7.3 of PegaCRM,jar: 

nohup /home/pegdev02/PRPC/Upgrade/117271 Pega8.7.3/scripts/utils/prpcUtils.sh import 

--archivePath PRPC/Upgrade/11258 PCRM 872/Resourcekit/PDFS/Rules/PegaCRM.jar | 

--prpcutils.property.filepath /home/pegdev02/PRPC/Upgrade/ 117271 Pega8.7.3 /scripts/utils/orpcUtils.properties > PegaCRM.jar./og & 


Upgrade PEGA 


Step 7 : Upgrade Custom Services For Financial Services (PCRMFS 
Execute script for each jar file in <<PCRMFS_folder>>/ResourceKit/PDFS/Rules in this order: 
- PegaCRMFS.jar 


Command: 
nohup /home/pegdev02/PRPC/Upgrade/<<Pega_base>>/scripts/utils/prpcUtils.sh | 
--archivePath PRPC/Upgrade/<<Pega_CRMFS_module>>/Rules/<<jar_file_name>> | 


--prpcutils.property.filepath /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils. properties > 
jar file name.log & 


Check the log file to confirm the BUILD SUCCESS or ERROR 


Example with version 8.7.3 of PegaCRMFS.jar: 

nohup /home/pegdev02/PRPC/Upgrade/117271 Pega8.7.3/scripts/utils/prpcUtils.sh | 

--archivePath PRPC/Upgrade/117161 PCRMFS 872/RulesPegaCRMFS.jar | 

--prpcutils.property.filepath /home/pegdev02/PRPC/Upgrade/ 117271 Pega8.7.3/scripts/utils/prpcUtils. properties > PegaCRMFS.jar_03112022.log & 


Upgrade PEGA 


Step 8 : Integrate Customer For Financial Services sample datas (not 


mandatory) 


Execute script for each jar file in <<PFFS module>>/SampleData in this order: 


- PegaFFS SampleSchema.jar 

- PegaFFS SampleDatalnstances.jar 
- PegaFFS_ SnapSchema.jar 

- | PegaFFS SnapDatalnstances.jar 


Command: 
nohup /home/pegdev02/PRPC/Upgrade/<< Pega base folder>>/scripts/utils/prpcUtils.sh | 
--archivePath PRPC/Upgrade/<<PFFS folder>>/SampleDatayjar file name | 


--prpcutils. property.filepath /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/utils/prpcUtils.properties > 
<<jar file log>>.log & 


Check the log file of each jar execution to confirm the BUILD SUCCESS or ERROR 


Upgrade PEGA 


Troubleshooting 


ERROR on upgrade CORE process (STEP 3 
- Identify the error/exception in the associate log file 
- Fix error 


- Change the property in /home/pegdev02/PRPC/Upgrade/<< Pega base>>/scripts/setupDatabase.properties 


- automatic.resume=true 


- Execute again the upgrade command 


ERROR on upgrade module process 
- Identify the error/exception in the associate log file 


- Fix error 


- Execute again the upgrade command 


Upgrade PEGA 


Last Upgrade version 8.7.3 times (applied on database PEGZD103 


module component Duration 

Base package 145 min 49 seconds 

Foundation Financial Services PegaFFS.jar 56 min 17 seconds 
PegaFFS Sample.jar 38 min 7 seconds 
PegaFFS Schema.jar 35 min 35 seconds 
PegaFFS Datalnstances.jar 31 min 58 seconds 
PegaFFS Int.jar 35 min 50 seconds 

Foundation Product Financial Services PegaPDFS.jar 38 min 32 seconds 


PegaPDFS Implementation.jar 31min 58 seconds 


Customer Services PegaCRM.jar 114 min 13 seconds 
PegaCRM Patch.jar 40 min 20 seconds 
Customer Services For Financial Services PegaCRMFS.jar 60 min 4 seconds 
PegaCRMFS Patch.jar 40 min 20 seconds 
Customer Services For Financial Services Sample data PegaFFS SampleSchema.jar 35 min 44 seconds 
PegaFFS SampleDatalnstances.j 
ar 32 min 34 seconds 


Information: The time can be decrease with optimisation Script on 
peg data rule table 


